Decrements the reference count for an IconRef.

OSErr ReleaseIconRef (
    IconRef theIconRef
);

theIconRef

An IconRef whose reference count you wish to decrement.

function result

A result code.

DISCUSSION

When an IconRef’s reference count reaches 0, all memory allocated for the IconRef is marked as disposable. Any subsequent attempt to use the IconRef returns a result code of -2580 (invalidIconRefErr).

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when IconServicesLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by IconServicesLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/18/2000)